============================================================================

  ZTris 83 Readme File
  ~~~~~~~~~~~~~~~~~~~~
	The successor of the famous ZTetris by
		Jimmy Mrdell, Sam Heald, Patrick Davidson and Ahmed El-Helw
	A complete recode by Tijl Coosemans (tijl@ulyssis.org)

	website: http://tijl.studentenweb.org/

================================ version 1.3.2 == 06/02/2003 (MM/DD/YYYY) ==

 Features
 ~~~~~~~~
  * 21 levels (0-20). You can choose which level to start between
    (only start on level 0-9 though).

  * 16 different level patterns!

  * High score table with names! The three best results are saved.

  * Teacher key! If you see your teacher heading your way, quickly press
    the teacher key to return to TI-OS, and when you start the game the
    next time, you'll automatically resume where you were. If you run it
    from a shell however, it returns to the shell instead. But that's
    your problem, not mine :)

  * Linkplay! Play against each other and kick some butt! The link protocol
    is the same as in ZTris for the 82, 83, 83+(SE), 85, 86, so you could
    link each type of calc and play against each other!

  * The scoring is almost the same from the Game Boy version. The last digit
    in the score isn't shown (you could think of it that way anyway) because
    of several reasons.

  * You can start with trashlines. It's different from the gameboy version
    though, because there is no win-when-cleared-25-lines.

  * In linkplay, you can choose if you want to get scrambled (as in Tetris
    for Windows) or unscrambled (Tetris for Gameboy) lines.

  * Rotation in both directions.

  * You can pause the game (1 player)

 How To Play
 ~~~~~~~~~~~
  Venus 2.0 or higher has to be installed. Then just start ZTris by running
  prgmZTRIS... Have Fun!
  (You can also run ZTris from a Venus Explorer.)

  IMPORTANT: ZTris is not compatible with ZTetris. Make sure that in two
	player mode both calculators are running ZTris.

 Control
 ~~~~~~~
  * At The Option Menu:
		Arrows		- Choose level
		Y=		- Choose number of players
		Window (2pl)	- Toggle "2-4 lines", "1-3 lines"
		Zoom (2pl)	- Toggle scrambled/unscrambled lines
		Trace		- Decrease start height
		Graph		- Increase start height
		Enter / 2nd	- Start level
		Clear		- Quit game

  * In Game:	Left & Right	- Move the piece to the left and right
		Down		- Move the piece faster down
		Up & 2nd	- Rotate clockwise
		Alpha		- Rotate counterclockwise
		xton		- Drop key
		Mode		- Togle Paused mode
		Clear		- Quit game
		Del		- Teacher key. Quickly jumps out to TI-OS.
				  The game will resume when you start it
				  the next time.
  * When typing name:  (no need to press alpha)
		A-Z, Space	- Enter letter (max 10 chars)
		Enter		- Continue
		Del		- Backspace

 Scoring
 ~~~~~~~
             L 0   L 1   L 2   L 3   L 4   L 5   L 6   L 7   L 8    L 9
  1 line   |   4 |   8 |  12 |  16 |  20 |  24 |  28 |  32 |   36 |   40 |
  2 lines  |  10 |  20 |  30 |  40 |  50 |  60 |  70 |  80 |   90 |  100 |
  3 lines  |  30 |  60 |  90 | 120 | 150 | 180 | 210 | 240 |  270 |  300 |
  4 lines  | 120 | 240 | 360 | 480 | 600 | 720 | 840 | 960 | 1080 | 1200 |

  Every time you move the piece down (with the down key) you will
  increase the score with 0.1. When dropping a piece, your score will
  increase with the number of dropsteps times 0.1.
  (the last digit, although not shown, will remain in memory)

 Linkplay
 ~~~~~~~~
  To play linkplay, first connect two calculators and choose two player
  mode. The level selection menu looks slightly different. Besides from
  choosing which level to start at (the two players can start at different
  levels), you can choose how many penalty lines should be sent to the
  other calc when clearing lines. Either you send 2-4 lines (if you get
  2-4 lines) or 1-3, ie one line less than you cleared. This option can
  also be different on both calcs, thus allowing handicap. You can also
  toggle if you want to get unscrambled penalty lines or scrambled penalty
  lines. If choosing unscrambled (default), the lines sent to you will only
  have one gap, making it much easier than getting totally scrambled lines.

  Press Enter to start the game. Now the calc will go into waiting mode and
  wait until the other player has reached this mode.

  Now the fun begins!

  You play as you usually do, but when you clear 2 or more lines, the other
  opponent will get penalty lines depending on how many lines you cleared
  and the option choosed when selecting startlevel.

  There is also a bar telling how high up in the playing field your
  opponent is. This is good when choosing strategy.

  When a player loses, or aborts the game, a "You win" message will appear
  on the other calc.

  You can't pause or use the teacher key in two player mode.

 Thanks
 ~~~~~~
  * Jimmy Mrdell for making ZTetris
  * Sam Heald for porting it to the TI-82
  * Ahmed El-Helw for porting it to the TI-83 and TI-83+
  * To all the people who helped them
    - Pascal Bouron	- great link routines!
    - Martin Hock	- example source on how to use those link routines
    - Florent Dhordain	- the link routines!
    - CalcEm Author	- His emulator was a huge help!
    - Joe Wingbermuehle	- helped with backgrounds
			- the faster graph buffer copy [and fixing it!]
    - Mark May (OBD)	- beta testing and trying to help
    - Dines Christy Justesen
			- Trying to help
    - Derrick Ward	- beta testing, trying to help when possible, and
			  maintaining our page.
    - Bryan Rabeler & Kouri Rosenberg and the rest of the beta testers...
    			- For repeatedly crashing their calcs for good of
			  Ztetris.
    - ....and most of all
      Patrick Davidson	- For teaching me (Sam) everything I know about
			  asm, and solving the major bugs that I (Sam)
			  could not.
  * Henk Poley for beta testing
  * Jean Carot for beta testing
  * Dan Weiss for mentioning the split screen bug
  * Ron for mentioning the drop key bug

 History
 ~~~~~~~
<-> version 1.3.2 - 20030602 -- size: 2409
	* Made it compatible with Venus 2.3

<-> version 1.3.1 - 20021124 -- size: 2410
	* Made it compatible with Venus 2.2

<-> version 1.3 - 20020228 -- size: 2405
	* Found a way to wrap an error handler arround the TIOS link
	  routines, so I could use those instead of my own, which reduced
	  the total size quite a bit
	* Slight change in the options screen
	* Some optimizations here and there

<-> version 1.2 - 20020213 -- size: 2468
	* Improved link play synchronisation
	* Some optimizations in the screen drawing routines

<-> version 1.1 - 20020102 -- size: 2472
	* Fixed split screen bug
	* Fixed drop key bug
	* Fixed bug that caused both calcs not having the same pieces in
	  two player during the second game
	* Dropped contrast changing and APD
	* Better random number generator
	* Restyled the Game Options screen
	* Made it Venus 2.x compatible
	* Added icon

<-> version 1.0 - 20011007 -- size: 2367
	* Complete recode! Exactly 972 bytes smaller than ZTetris
	* Improved link play
	  - much more stable
	  - the other calc doesn't have to be in the game before you can
	    enter the waiting mode
	  - both players get the same pieces !
	* Smoother key movement
	* Automatic Power Down after 1 minute in every front-game screen
	* Contrast changing in every front-game screen

============================================================================

	Tijl Coosemans, tijl@ulyssis.org

